package com.ruoyi.web.controller.post.mapper;

import java.util.List;
import com.ruoyi.web.controller.post.domain.PostRecommendationHistory;
import org.apache.ibatis.annotations.Param;

/**
 * 帖子推荐历史Mapper接口
 *
 * @author thunderhub
 */
public interface PostRecommendationHistoryMapper
{
    /**
     * 查询帖子推荐历史
     *
     * @param historyId 帖子推荐历史主键
     * @return 帖子推荐历史
     */
    public PostRecommendationHistory selectPostRecommendationHistoryById(Long historyId);

    /**
     * 查询帖子推荐历史列表
     *
     * @param postRecommendationHistory 帖子推荐历史
     * @return 帖子推荐历史集合
     */
    public List<PostRecommendationHistory> selectPostRecommendationHistoryList(PostRecommendationHistory postRecommendationHistory);

    /**
     * 新增帖子推荐历史
     *
     * @param postRecommendationHistory 帖子推荐历史
     * @return 结果
     */
    public int insertPostRecommendationHistory(PostRecommendationHistory postRecommendationHistory);

    /**
     * 修改帖子推荐历史
     *
     * @param postRecommendationHistory 帖子推荐历史
     * @return 结果
     */
    public int updatePostRecommendationHistory(PostRecommendationHistory postRecommendationHistory);

    /**
     * 删除帖子推荐历史
     *
     * @param historyId 帖子推荐历史主键
     * @return 结果
     */
    public int deletePostRecommendationHistoryById(Long historyId);

    /**
     * 批量删除帖子推荐历史
     *
     * @param historyIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deletePostRecommendationHistoryByIds(Long[] historyIds);

    /**
     * 根据用户ID获取访问过的帖子ID列表
     *
     * @param userId 用户ID
     * @return 帖子ID列表
     */
    public List<Long> selectVisitedPostIdsByUserId(@Param("userId") Long userId);

    /**
     * 检查用户是否访问过某个帖子
     *
     * @param userId 用户ID
     * @param postId 帖子ID
     * @return 推荐历史记录
     */
    public PostRecommendationHistory selectByUserIdAndPostId(@Param("userId") Long userId, @Param("postId") Long postId);

    /**
     * 根据用户ID和帖子ID删除访问记录（用于数据清理）
     *
     * @param userId 用户ID
     * @param postId 帖子ID
     * @return 结果
     */
    public int deleteByUserIdAndPostId(@Param("userId") Long userId, @Param("postId") Long postId);

    /**
     * 获取用户最近访问的帖子记录
     *
     * @param userId 用户ID
     * @param limit 查询数量限制
     * @return 推荐历史记录列表
     */
    public List<PostRecommendationHistory> selectRecentVisitsByUserId(@Param("userId") Long userId, @Param("limit") int limit);

    /**
     * 清理用户过期的访问记录（超过指定天数的记录）
     *
     * @param userId 用户ID
     * @param days 天数
     * @return 删除的记录数
     */
    public int deleteExpiredRecordsByUserId(@Param("userId") Long userId, @Param("days") int days);
}